home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / musik / SMACHN36 / ENGLISH / SMACHINE.TXT < prev    next >
Encoding:
Text File  |  1999-08-23  |  8.1 KB  |  136 lines
  1.   /---
  2.   |
  3.   |                    S o u n d   M a c h i n e   I I I
  4.  
  5.                           -thenewgenerationofplayerzz-                      |
  6.                                                                             |
  7.                                                                          ---/
  8.  
  9. =========| Contents |===========================================================
  10.  
  11. 1. Quick description of Sound Machine III
  12. 2. Presentation of the main dialog box
  13. 3. Technical informations, bugs and limitations
  14.  
  15. =========| Part 1 |=============================================================
  16.  
  17.      Sound Machine is a soundchip player. It should work on all Atari computers
  18. (on 520 STFM/STE, you will perhaps have to start your computer without any
  19. programs in memory). This software has been tested on an STE with 4 Mb memory
  20. and a standard Falcon in VGA mode. It will surely runs on STFM, Mega ST and Mega
  21. STE. Problems may appear with TT and clones about some music formats which don't
  22. run on Falcon.
  23.  
  24.      Another player ? Yeah, but this one is different. First of all, it has been
  25. fully rewritten with GEM-compatible code, it means you can use it in all the
  26. resolutions but in multitask (despite of a GFA bug). It is particularly easy to
  27. use, even for a person who doesn't know the wonderful world of soundchips.
  28. Furthermore, Sound Machine is the only software which allows to play unknown
  29. soundchips by setting the different parameters. Of course, it is possible to
  30. save these unknown musics into Sound Machine's built-in format. Sound Machine
  31. III is fully compatible with the files created by the good old Sound Machine
  32. 2.5 and 3.0. And that's only a little part of its abilities.
  33.  
  34.      What is a soundchip ? That's a 3 voice music which uses Yamaha sound co-
  35. processor's synthetic sounds. Some musics allow sampled sounds, for the drums
  36. for example : those are digidrums (also called halftracks). Other musics sound
  37. like the good old C 64 tunes : they are called Sid-Voice musics.
  38.  
  39. =========| Part 2 |=============================================================
  40.  
  41.      The main dialog box can be divided into 3 parts : file information, the
  42. parameters and the GEM buttons.
  43.  
  44. * The first lines give some useful information such as the file name or its
  45. length. You will find bellow these info a short description on the file loaded
  46. in memory (format, author, more info, etc.).
  47.  
  48. * Parameters are numerous, I'm going to describe them :
  49.   - 1st init : the first offset to initialize the music.
  50.   - 2nd init : another offset to initialize digidrum musics.
  51.   - Play : the main offset, it will play the music at each VBL.
  52.   - 1st stop : the first offset to stop the music.
  53.   - 2nd stop : another offset to stop digidrum musics.
  54.   You'll note it is possible to (un)select a button in the front of "2nd init"
  55.   and "2nd stop". It means you can decide to call or not these two offsets. They
  56.   are especially used for digidrum musics.
  57. IMPORTANT : if you're a beginner, avoid modifying these parameters else Sound
  58. Machine will crash.
  59.   - Music number at the beginning : sometimes, a file can contain several tunes.
  60.   The right values must be included between -1 and 15.
  61.   - Music number at the end : when a music ends, the routine sometimes need a
  62.   particular music number (e.g. : -1 for the Lotus format).
  63.   - Several musics in the file : now you know that a file can contain several
  64.   tunes. If this option is activated, you will be able to change tune with the
  65.   "+" and "-" keys when the music is playing. Some formats dislike this possibi-
  66.   lity and crash, so be careful. Please note that with the "+" and "-" keys,
  67.   the values must are included between 0 and 31. Beware to the bombs !
  68.   - This music should run on Falcon : if you own an ST, you don't mind. If you
  69.   habe got a Falcon, activate this option if you are sure that the music in RAM
  70.   will work on you computer. Anyway, when a file is loaded, Sound Machine verify
  71.   if this music can be played on a Falcon.
  72.  
  73. * The buttons are quite numerous too :
  74.   - LOAD : you can load a file into the memory. Sound Machine attempts to iden-
  75.   tify the format of the file (among 72 recognized formats). If the file is
  76.   recognized, Sound Machine will display the right parameters in the main dialog
  77.   box. Of course you can modify them if you want.
  78.   - PLAY : allows to play the music. If the format is unknown, Sound Machine
  79.   asks you if you want to play it regarding to the parameters in the main dialog
  80.   box. If you own a Falcon and if the music can't be played on it, you can force
  81.   Sound Machine playing the music (e.g. if you use Backward). Moreover, all the
  82.   recognized formats aren't played by Sound Machine, such as soundtracks and
  83.   samples. Indeed, Sound Machine has been coded in GFA Basic and better players
  84.   for these kind of files exist (MegaTracker Player or Paula for soundtracks,
  85.   BackGround Player or SAM for samples).
  86.   - SAVE : the file in memory will be saved.
  87.   - See header : allows you to see the first 200 bytes of the file in memory.
  88.   - Convert & save : the file currently in memory will be converted into the
  89.   Sound Machine III and then saved on disk.
  90.   - About : some information about Sound Machine.
  91.   - Options : allows you to have some useful info : kind of computer (if you are
  92.   using an emulator), free RAM and used RAM. You can set the software up too :
  93.   you can choose Sound Machine asks you a confirmation before playing an unknown
  94.   type of music. You should activate this option if you're a beginner. Thanks to
  95.   the second option, you can limit the size of the reserved memory for the GEM.
  96.   Of course, this size will only be taken into consideration the next time you
  97.   will start Sound Machine (if you've saved the options before).
  98.   - Extract & save : when a music is converted into the built-in format, Sound
  99.   Machine just add some bytes at the beginning of the original file. So, this
  100.   option will do the contrary and will remove these bytes. The new file will be
  101.   saved.
  102.   - Exit : guess what... Sound Machine will ask you no confirmation.
  103.  
  104. =========| Part 3 |=============================================================
  105.  
  106.      In order to be played, a soundchip generally contains at the beginning of
  107. the file a routine which have to be called at each VBL. Indeed, at each VBL, the
  108. Atari will go and see in a special list which are the routines to be executed.
  109. But there can be only 8 places in this list. So, when you run Sound Machine, it
  110. will go to this list and, if there is room enough, it will note this place and
  111. will use it to play soundchips later. If there is no room enough then Sound
  112. Machine will go back to the GEM Desktop. So be carefull is you really want to
  113. use Sound Machine under a multitasking OS. There is a problem with the VBL : if
  114. your screen isn't in the 50 Hz mode (e.g. VGA, monochrom...), the musics won't
  115. be played at the right speed. The solution consists in playing the music with
  116. the timers of the MFP instead of the VBL, but the MFP programmation is very
  117. difficult with GFA. For the moment, only the Sid Sound Designer musics use the
  118. timers instead of the VBL.
  119.  
  120.      I've recently noted that Millenium Brothers musics are a bit particular...
  121. If you want to play such tunes, click first on "Several musics in the file", hit
  122. the "-" key and click on "Play". Another problem, but on Falcon with Backward
  123. only : after a Count Zero music, your computer could stop if you want to load
  124. another file or to exit Sound Machine. I don't know the reason why it bugs...
  125.  
  126.      Concerning the limitations, you can't run Sound Machine as an accessory.
  127. Well, in fact you can virtually do it, but you will only be able to use it once
  128. because it wasn't made for this ! You can't use it in a multitask OS as a back-
  129. ground application because its dialog boxes don't enjoy multitasking very much.
  130. Why ? Because Sound Machine plays soundchips and it must be very carefully and
  131. clean if you don't want your system crash. Playing soundchips in background is
  132. more difficult than playing samples or soundtracks.
  133.  
  134.  
  135.                                                 End of doc - Have a lot of fun !
  136.